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GRADE POINT CORRELATION 


DECUS Program Library Write-up 


DECUS NO. 8-387 


Abstract 

This package of programs calculates correlation matricies for p 
samplings of a real variable (e.g. student grade point ratios) with n 
Boolean variables (e.g. subjects taken). The programs can also cor¬ 
relate combinations of the n variables taken m at a time with the real 
variable. Included in the package are a versatile data tape editor which 
can be used to prepare an input data tape for the correlator and a pro¬ 
gram which converts the output of the correlator into percentage correla¬ 
tion matricies. 

Minimum Hardware 

All programs will run on a 4K-PDP-8 with teletype. 

Other Programs Required 

The program which calculates percentage correlation matricies re¬ 
quires the FORTRAN compiler and operating system. 








General 


This package includes three programs: a date tape editor for 

preparing data tapes for the correlator, a grade point correlator 
Which calculates raw correlation matricies, and a FORTRAN program which 
converts the raw matricies into percentage matricies. We describe the 
main correlator first. 

The Main Correlator 

Let us consider the hypothetical case of a school trtiich wishes to 
determine how the grade point averages of its students relate to the sub¬ 
jects taken. To solve this problem with the grade point correlator, the 
user prepares an input tape which contains for each student the subjects 
he took and his end of semester grade point average. For example, suppose 
the subjects considered are A, B, and C, and the school's grading system 
is such that the grade point average is between 0 and 4.00. Hie corre¬ 
lator can be instructed to count the number of students who took subject 
A with a grade point average between 0 and .25, the number who subject A 
with a grade point average between .26 and .50, etc. It will then repeat 
the process for subjects B and C. 

The correlator can also aorrelate combinations of subjects with the 
grade point averages. That is, it can be instructed to count the number 
of students who took both subjects A and B and who made a grade point 
average between 0 and .25, etc. It will then repeat the correlation for 
subjects A and C; and B and C. Op to 9 subjects may be correlated in 
all combinations with the grade point average. 

Operating Instructions 

Hie main correlator consists of two tapes both of which must be 
loaded into the machine with the binary loader. These tapes are labeled 
"Grade Point Correlator" and "Subroutines for Grade Point Correlator." 

The second tape contains I/O subroutines for the correlator and other 
utility programs. 

The program starts in 0400g. Upon starting the program, the operator 
types in two positive integers separated by exactly one space. If these 
integers are m and n, respectively, the program will correlate n subjects 
taken m at a time. 

The data tape is then run through by placing it in the appropriate 
reader*. After the data tape has been completely read in, the operator 
types a 2 on the keyboard and the computer will print out the results 
of the correlation. 


*As initially supplied the program runs on the LSR and LSP. However, 
it is easily modified to run on other input-output equipment. 





Data Tape Preparation. 

order to prepare the data tape, a number is assigned to each sub¬ 
ject. For instance, if the school is concerned with subjects A, B, and C, 
it could assign the number 1 to subject A, 2 to subject B, and 3 to sub¬ 
ject C. 

The data for each student is put on the tape as follows. The first 
number on the tape is 1 if the student took the subject A and 0 if he 
did not take subject A. The second number on the tape is 1 if the student 
took subject B and 0 if he did not. This pattern continues until n values 
have been entered on the tape. Following these n values, the grade point 
average appears. This number must have a decimal point in it and must 
not contain more than two digits after the decimal point. 

Each number must be separated by exatly one non-numeric character 
other than blank tape or a rubout. Blank tape and rubouts are ignored, 
and any amount of either may appear anywhere on the tape. 

Output of Correlator. 


The output of the correlator consists of a series of matricies of 
the form 




n 3 * * 

• n a 

a ll 

a 12 

a 13 

a i4 

a 21 

a 22 

a 23 

a 24 

a 31 

a 32 

a 33 

a 34 

a 4l 

a 42 

a 43 

a 44 

n 3 . . 

. n m identifies 

the matrix 


tnose students who took subjects nj, n 2 , ..., n m . 
number of students who took subjects m n— 

. . _ ^ *» • • • "in 

point average between 

(i-1) * .25 (j-1) + .01 

and 


(aij) as relating to 
The element aj.-j is the 
and who made a grade 


(i-1) + . 25j 

except for all where the lower limit is 0 instead of .01. 


Percentage calculator. 


If it is desired to calculate percentage correlation matricies, gene¬ 
rate leader with the teletype of-line. Turn punch off, switch teletype 
to lien, start computer, and type m and n on the keyboard. Then place 
data tape in reader, turn reader on, and wait until the computer has 
finished reading in data tape. Then type 2 on the keyboard, turn punch 
on, and type a space. After the computer has finished its output, 
generate tralier. Repeat this procedure for as many sets of data as 
required. 
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Now compile the FORTRAN program (unless this has already been done.) 
Load the FORTRAN operating system and compiled program. For eaeh set of 
results from the correlator, start the FORTRAN program, type in the 
value of m, place output tape from the correlator in reader, and turn 
reader on. The output of the percentage calculator is the sum of all 
the matrix elements for a particular matrix and another matrix of percen¬ 
tages..The percentage matrix has the sam6 format as the original matrix 
from the correlator. 

Note that the percentage calculator must be stopped and restarted 
for every set of results from the correlator. 

Data Tape Editor 

The data tape editor can be used to select numbers from a master 
data tape and prepare a punched tape which can then be used as input to 
the correlator routine. For example, the master data tape may contain 
sets of 19 numbers. Each set of numbers constitutes the data for a 
particular student. These numbers may be spaced in any format on the 
tape but must be terminated by an ASCII code for a non-numeric item 
(except *V’). 

Suppose it is desired to select the l 8 *", 2 n< ^, and 9*"* 1 numbers out 
of each set of 19 numbers. Then the data tape editor is loaded by the 
binary loader. The user must then set the contents of locations 401 g 
through 424 g as follows. 


401 

1 

412 

0 

402 

0 

413 

0 

403 

0 

414 

0 

404 

0 

415 

0 

405 

1 

416 

0 

406 

0 

417 

0 

407 

0 

420 

0 

410 

0 

421 

0 

411 

1 

422 

0 



423 

0 



424 

-1 


Note that the 1 st , 5 th , and 9 th locations after 400 8 have 1 in them 
while the others have a 0 except for 424 which has -1 to signify the end 
of a set of data. 

The user then starts the editor in 02008, places the master tape in 
the reader, and turns the reader on. (Note: Leader and trailer must be 
generated with the teletype off-line. 

Miscellaneous 

All of these programs are originally written to work with the ASR-33 
teletype, but they may be modified to work with any input device. 

The main routine echos the input to it; this may be suppressed by 
making the following changes. 
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Change Location From To 

0447 4401 7000 

0267 4340 7000 

The main correlator and its subroutines occupy locations 0000 through 
0663. The amount of memory required by a particular run can be calculated 
from the formula 

664p + m + n nj 

ml cn-m):. 

If this is larger than 7600, the computer will print OF and stop. 

It cannot be restarted. 
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